Inside Macintosh: QuickDraw GX Objects /

Chapter 7 - View-Related Objects / View-Related Objects Reference

View Device Functions / Manipulating View Device Object Properties

GXSetViewDeviceViewGroup

You can use the GXSetViewDeviceViewGroup function to assign a view device object to a specified view group.

void GXSetViewDeviceViewGroup(gxViewDevice target, 
                              gxViewGroup group);

target

A reference to the view device whose view group you wish to change.

group

A reference to the view group to which the view device is to be assigned.

DESCRIPTION

The GXSetViewDeviceViewGroup function changes the target view device to the specified view group.

SPECIAL CONSIDERATIONS

You cannot assign a view device to the onscreen view group; do not specify gxScreenViewDevices for the group parameter. Also, you cannot change the view group of a view device already in the onscreen view group.

ERRORS, WARNINGS, AND NOTICES

Errors
invalid_viewDevice_reference
invalid_viewGroup_reference
viewDevice_access_restricted	(debugging version)
Notices (debugging version)
viewDevice_already_in_viewGroup

SEE ALSO

For an example of the use of this function, see Listing 7-10 on page 7-54.

To get a view device's view group, use the GXGetViewDeviceViewGroup function, described in the previous section.

The gxScreenViewDevices view group reference is described in the section "View Group Types" on page 7-69.